home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / compress / shaid220.zip / ARCHID.FIN < prev    next >
Text File  |  1997-04-30  |  16KB  |  365 lines
  1. SH Archive Identifier versio 2.10           (c) 1996-1997 SH Software
  2. Dokumentti
  3.  
  4. Mikä?
  5. -----
  6. SH Archive Identifier on pieni ohjelma, jota käytetään komentoriviltä
  7. erilaisten pakettien tunnistamiseen.
  8.  
  9. Se kertoo sanallisesti minkä tyyppinen tiedosto on kyseessä ja palauttaa
  10. sille tiedostolle kuuluvan errorlevelin dosille. Sitä voidaan käyttää
  11. sekä yhden tiedoston tunnistamiseen, jolloin errorlevel palautetaan, tai
  12. monien tiedostojen tunnistamiseen jolloin yksi tietty errorlevel palautetaan
  13. osoittamaan että jokerimerkkejä on käytetty.
  14.  
  15. Käyttö
  16. ------
  17. Omassa BBS:ni (Reflection) käytän tätä satunnaisesti nimetyn mainoksen
  18. (random ad) lisäämiseen pakettiin, koska käyttämäni upload checkeri ei
  19. tätä ominaisuutta tue. Toki sitä voi käyttää esim. virusten
  20. tarkastamiseen paketin sisältä jne.
  21.  
  22. Mukana tässä paketissa on kaksi BAT-tiedostoa demonstroimassa SH Archive
  23. Identifierin toimintaa ja monipuolisuutta. Ensinnäkin mukana on
  24. PCBTEST.BAT jota voi käyttää battien rakentamisen pohjana. Toiseksi on
  25. ACVT.BTM (4dosin bat-tiedosto) jolla voidaan muuntaa ZIP-, ARJ-, JAR- ja
  26. RKive-paketteja toistensa välillä.
  27.  
  28. Lista errorleveleistä ja lyhytnimistä
  29. -------------------------------------
  30. Listan näyttää lyhyesti myös ARCHID itse.
  31.  
  32. Lyhyt-kohdassa on "kutsumanimi", jolla kerrotaan tyyppi ARCHID:ille
  33. jos ei haluta käyttää oletus errorleveleitä - kts. kohta Käyttötavat.
  34.  
  35. ─────────────────────────────────┬─────┬────────────────────────────────
  36. Oletus errorlevel - selitys      │Lyhyt│ Testattu / tietoa
  37. ─────────────────────────────────┼─────┼────────────────────────────────
  38.  1 - ARJ-paketti              │arj  │ ARJ 0.20, 1.10, 2.00, 2.10,
  39.                   │       │   2.20, 2.30, 2.50a, 2.55b
  40.  2 - ZIP-paketti              │zip  │ PKZIP 2.04g, ZIP 2.0
  41.  3 - RAR-paketti              │rar  │ RAR 1.55, 2.00 beta, 2.00, 2.01
  42.  4 - LHA-paketti              │lha  │ LHA 2.13, 2.55b, 2.66
  43.  5 - LHarc-paketti          │lharc│ LHA 2.13:lla tehty "vanha"
  44.  6 - UC2-paketti              │uc2  │ UC r3 pro
  45.  7 - GZIP (GNU ZIP)-paketti      │gzip │ GNUZIP 2.1.4
  46.  8 - ARC-paketti              │arc  │ ARC 6.02
  47.  9 - HA-paketti              │ha   │ HA 0.999b
  48. 10 - Hyper-paketti          │hyp  │ HYPER 2.5, 2.6 (german)
  49. 11 - PAK-paketti              │pak  │ PAK 2.10
  50. 12 - PKPAK-paketti          │pkpak│ PKPAK 3.61
  51. 13 - SQZ-paketti              │sqz  │ SQZ 1.08.3
  52. 14 - ZOO-paketti              │zoo  │ ZOO 2.1
  53. 15 - AIN-paketti              │ain  │ AIN 2.2
  54. 16 - ARX-paketti              │arx  │ ARX 1.0
  55. 17 - BSA-paketti              │bsa  │ BSA 2.00
  56. 18 - ChArc-paketti          │chz  │ CHARC 1.2
  57. 19 - Codec-paketti          │cdc  │ CODEC 3.10
  58. 20 - HAP 3-paketti          │hap  │ HAP 3.00
  59. 21 - HPack-paketti          │hpk  │ HPACK 0.79c0
  60. 22 - CrossePAC-paketti          │pac  │ CPAC 1.35
  61. 23 - JRchive-paketti          │jrc  │ JRC 1.10
  62. 24 - Limit-paketti          │lim  │ LIMIT 1.2
  63. 25 - MAR-paketti              │mar  │ MAR 1.0
  64. 26 - PUT & GET -paketti          │put  │ PUT 3.34
  65. 27 - SAR-paketti              │sar  │ SAR 1.00
  66. 28 - SqWez-paketti          │sqw  │ SQWEZ 2.2
  67. 29 - Quantum-paketti          │paq  │ QUANTUM 0.96 beta, 0.97 beta
  68. 30 - YAC-paketti              │yac  │ YAC 1.02
  69. 31 - X1-paketti              │x1   │ X1 0.94h beta
  70. 32 - AMGC-paketti           │amg  │ AMGC 2.2
  71. 33 - DWC-paketti              │dwc  │ DWC A5.01
  72. 34 - Larc-paketti           │lrc  │ LARC 3.33
  73. 35 - LHark-paketti          │lhk  │ LHARK 0.3o
  74. 36 - FOXSQZ-paketti          │fox  │ FOXSQZ 1.6i BETA
  75. 37 - MDCD-paketti           │md   │ MDCD 1.0
  76. 38 - Quark-paketti          │ark  │ QUARK 1.0beta
  77. 39 - ACB-paketti              │acb  │ ACB 1.13b, 1.23b, 1.29b, 2.00c
  78. 40 - RKive-paketti          │rkv  │ RKive 1.0, 1.1, 1.2, 1.3, 1.4
  79. 41 - JAR-paketti              │jar  │ JAR 1.01 beta_2, 1.01 beta_3
  80. 42 - Dirks Pack-paketti          │dpa  │ DPA 1.1a
  81. 43 - ESP-paketti              │esp  │ ESP 1.8, 1.9beta
  82. 44 - ARJZ-paketti           │arjz │ ARJZ 0.15 alpha
  83. 45 - UFA-paketti              │ufa  │ UFA 0.00 (Alpha+Gamma)/2, 0.01
  84. 46 - TSComp-paketti          │tsc  │ The Striling Compressor 1.3.21
  85. 47 - LEO-paketti              │leo  │ PakLEO 1.06
  86. 48 - ZAR-paketti              │zar  │ Zip-Archiv 2.00
  87. 49 - SKY-paketti              │sky  │ SKY 1.01, 1.02, 1.03
  88. 50 - SOF-paketti              │sof  │ RESOF 2.0B
  89. 51 - ZPack-paketti          │zpk  │ ZPack Lite 1.0
  90. 52 - MP3-paketti              │mp3  │ Power Compressor III
  91. 53 - ZET-paketti              │zet  │ ZET 0.10 BETA
  92. ─────────────────────────────────┼─────┼────────────────────────────────
  93. 101- ARJ SFX ajetteva tiedosto   │arj-x│ ARJ 2.20, 2.50a, 2.55b
  94. 102- ZIP SFX ajetteva tiedosto   │zip-x│ PKZIP 2.04g, InfoZip 5.20
  95. 103- ZIP SFXjr ajetteva tiedosto │zjr-x│ PKZIP 2.04g
  96. 104- RAR SFX ajetteva tiedosto   │rar-x│ RAR 1.55, 2.00 beta, 2.00
  97. 105- LHA SFX ajetteva tiedosto   │lha-x│ LHA 2.13, 2.55b, 2.66
  98. 106- LHarc SFX ajetteva tiedosto │lhc-x│ (testattu)
  99. 107- ARX SFX ajetteva tiedosto   │arx-x│ ARX 1.00, sekä COM että EXE
  100. 108- BSA SFX ajetteva tiedosto   │bsa-x│ BSA 2.00
  101. 109- ChArc SFX ajettava tiedosto │chz-x│ CHARC 1.2
  102. 110- SqWez SFX ajettava tiedosto │sqw-x│ SQWEZ 2.2
  103. 111- SQZ SFX ajettava tiedosto   │sqz-x│ SQZ 1.08.3
  104. 112- SQZ SFXjr ajettava tiedosto │sqj-x│ SQZ 1.08.3
  105. 113- PAK SFX ajettava tiedosto   │pak-x│ PAK 2.51
  106. 114- LARC SFX ajettava tiedosto  │lrc-x│ LARC 3.33, sekä COM että EXE
  107. 115- LHark SFX ajettava tiedosto │lhk-x│ LHARK 0.3o
  108. 116- Quark SFX ajettava tiedosto │ark-x│ Quark 1.0beta
  109. 117- ESP SFX ajettava tiedosto   │esp-x│ ESP 1.8, 1.9beta
  110. 118- AIN SFX ajettava tiedosto   │ain-x│ AIN 2.32
  111. 119- LEO SFX ajettava tiedosto   │leo-x│ PLL2EXE 1.05
  112. ─────────────────────────────────┼─────┼────────────────────────────────
  113. 248 - Jokerimerkkejä käytetty    │       │ Jos jokerimerkkejä käytetään,
  114.                   │       │ mitään yllä olevista leveleistä
  115.                   │       │ ei palauteta vaan tämä.
  116. 249 - Viallinen lyhytnimi          │       │ Parametreinä 2-x annettua
  117.                   │       │ pakkerin kutsumanimeä ei ole
  118.                   │       │ tunnistettu. Kts. käyttötavat.
  119. 250 - Muisti ei riitä          │       │ Puskuria varattaessa muisti ei
  120.                   │       │ riitä, muistia tällöin vähemmän
  121.                   │       │ kuin 70 kT.
  122. 251 - Tiedoston sulkuvirhe       │       │ Ei pitäisi koskaan tapahtua.
  123. 252 - Tiedoston lukuvirhe          │       │ Todennäköisesti liian pieni
  124.                   │       │ tiedosto (ei oikea paketti tai
  125.                   │       │ vaurioitunut).
  126. 253 - Tiedostoa ei löydy          │       │ Parametrinä annettua tiedostoa
  127.                   │       │ ei ole.
  128. 254 - Ohjeruutu              │       │ Jos parametriä ei anneta.
  129. 255 - Ei tunnistettu          │       │ Tiedosto on joku, jota ei
  130.                   │       │ tunnisteta.
  131. ─────────────────────────────────┴─────┴────────────────────────────────
  132.  
  133. Käyttötavat
  134. -----------
  135. ARCHID            pelkästään näyttää lyhyen apuruudun: käyttö, lista
  136.             errorleveleistä, 5-kirjaimisista kutsumanimistä ja
  137.             pakettityypeistä.
  138.          Ruutun tulee automaattisesti paussi, jos ruutu ei
  139.             riitä rivimäärältään (alle 50) eikä sitä ole uudelleen-
  140.             ohjattu mihinkään (esim. tiedosto, printteri).
  141.  
  142. ARCHID <tied>    suorittaa tiedoston tunnistuksen: kertoo paketin
  143.             tyypin ja palauttaa dosille errorlevelin (listattu
  144.             edellisessä).
  145.  
  146.             Esim.
  147.          C:\>archid test.arj
  148.          C:\TEST.ARJ - Recognized as ARJ archive (1).
  149.  
  150.          C:\>archid test.exe
  151.          C:\TEST.EXE - Recognized as ARJ SFX executable (101).
  152.  
  153.          C:\>archid test.a*
  154.          C:\TEST.ARJ - Recognized as ARJ archive (1).
  155.          C:\TEST.A01 - Recognized as ARJ archive (1).
  156.  
  157. ARCHID <tied> <nimi> [nimi..]
  158.             Nimen kohdalla käytetään pakkaajan 5-kirjaimista
  159.             kutsumanimeä. Tämän käyttö vastaa TESTFILE:n käyttöä.
  160.  
  161.             Esim.
  162.          C:\>archid test.arj zip rar lha arj
  163.          C:\TEST.ARJ - Recognized as ARJ archive (4).
  164.  
  165.             Toisin sanoen paluuarvo on se, monesko kutsumanimeä
  166.             vastaava tyyppi on listassa.
  167.  
  168.          C:\>archid test.exe zip rar lha arj
  169.          C:\TEST.EXE - Recognized as ZIP SFX executable (255).
  170.  
  171.             Tällä käytöllä ARCHID kuitenkin palauttaa aina 255
  172.             (=ei tunnistettu), vaikka ARCHID tunnistaisikin
  173.             kyseisen paketin, mutta sitä ei ole listattu
  174.             parametreissä.
  175.  
  176. Yhteys tekijään
  177. ---------------
  178. Minulle saa lähettää palautetta, bugitietoja, tarvittavia lisäyksiä ym.
  179. kysymyksiä seuraavaan email-osoitteeseen: "eerheino@lkol.lpt.fi".
  180.  
  181. Reflection PCB aukeaa uudelleen alueella 03 myöhemmin 1997. En tiedä
  182. numeroa vielä, mutta jos luet tätä tuon ajankohdan jälkeen, voit etsiä
  183. numeron suomalaisista BBS-listoista.
  184.  
  185. Tunnetut ongelmat
  186. -----------------
  187. PKPAK- ja PAK-ohjelmilla luodut tiedostot havaitaan usein ARC-
  188. tiedostoina, jos ensimmäinen paketin tiedosto sattuu olemaan metodiltaan
  189. ARC-yhteensopiva. Tätä ei tietääkseni helposti voi saattaa toimivaksi,
  190. paitsi käymällä läpi kaikki tiedostot paketissa, ja se hidastuttaisi
  191. algoritmeja melkoisesti. Pakettien purkuun ym. käsittelyyn suosittelen
  192. vain PAK-ohjelman käyttöä, koska se tukee sekä ARC:illa että PKPAK:illa
  193. luotujen tiedostojen käsittelyä.
  194.  
  195. Ainakaan tämä versio ei tunnista muita kuin pakkereiden omia SFX-
  196. tiedostoja, vaikkapa ARJX:n MAKESFX:llä luotua SFX-tiedostoa ei
  197. tunnisteta.
  198.  
  199. Pyyntö pakkereiden tekijöille
  200. -----------------------------
  201. Huomautus pakkereiden tekijöille ympäri maailmaa! Kun julkaisette
  202. pakkerinne kansainväliselle yleisölle (tai sitä levitetään internetissä):
  203. muistakaa sisällyttää englanninkielinen versio ohjelmasta, tai
  204. vähintäänkin englanninkielinen versio dokumentista. On jo liikaa
  205. pakkereita, jotka ovat vain saksan-, venäjän-, japanin- tai ranskan-
  206. kielisiä. Pakkereiden mahdollisena käyttäjänä olen häiriintynyt tästä,
  207. kun en noita kaikkia kieliä ole opiskellut.
  208.  
  209. Mahdollisesti tulossa
  210. ---------------------
  211. - Paranneltuja tunnistusmekanismeja
  212. - Nopeutuksia (optimointia) koodiin
  213. - Erillinen OS/2-versio
  214. - TAR ja muita uusia tai tarpeellisia formaatteja
  215.   (jos sinulla on tietoa noista, lähetä emailia!)
  216.  
  217. Uusimman version saaminen
  218. -------------------------
  219. Kuten kaikki tietävät mikään ohjelma ei ole täydellinen. Päivitän tätä
  220. ohjelmaa jatkuvasti: korjaan virheitä, lisään formaatteja ja optimoin
  221. koodia.
  222.  
  223. SH Archive Identifierin uusimman version version saat internetistä
  224. osoitteesta "http://ameba.lpt.fi/~eerheino/shs/shaid.htm".
  225.  
  226. Jos et ole internetissä voit hakea sen myös Reflection PCB:stä
  227. kirjautumalla sisään nimellä "Support Download". Lisää Reflectionista
  228. on kohdassa "Yhteys tekijään".
  229.  
  230. Tekijänoikeudet
  231. ---------------
  232. Tässä dokumentissa tai itse ohjelmassa mainitut muut tuotteet:
  233.  
  234.     ACB, Associative Coder (c) George Buyanovsky
  235.     AIN             (c) Transas Marine (UK) Ltd
  236.     AMGC             (c) Milen Georgiev
  237.     ARC             (c) SEA (System Enhancement Associates)
  238.     ARCID,
  239.       Archive Identifier   (c) Stacy Smith
  240.     ARI             (c) RAO Inc
  241.     ARJ, ARJSFX         (c) ARJ Software, Robert K Jung
  242.     ARJX             (c) ROSE, Ralph Roth
  243.     ARX             (c) Michael A. Kosior
  244.     BSA             (c) PTS Ltd
  245.     ChArc             (ei saa selvää, todennäköisesti japania)
  246.     Codec             (c) Telvox Teleinformatica
  247.     CrossePAC         (c) Digital Strategies
  248.     DWC             (c) Dean W. Cooper
  249.     ESP             (c) GyikSoft
  250.     File Format List         (c) Max Maischein
  251.     FOXSQZ             (c) Master Creative Software, Inc.
  252.     GZIP, GNU ZIP         Part of the UN*X GNU project
  253.     HA             (c) Harri Hirvola
  254.     HAP             (c) Harald Feldman
  255.     HPack             (c) Peter Gutmann
  256.     Hyper             (c) P Sawatzki & K P Nischke
  257.     Info-Zip, ZIP         (c) Mark Adler, Richard B. Wales,
  258.                   Jean-loup Gailly, Kai Uwe Rommel
  259.     JRchive, JRC         (c) Jayar Systems
  260.     Larc             (c) K. Miki, H. Okumura, K. Masuyama
  261.     PakLEO, UnPakLEO,
  262.       PLL2EXE         (c) ThunderSoft, Leonardus Leonardi
  263.     LHA, LHarc, LHA SFX    (c) Haruasy Yoshizaki
  264.     LHark             (c) Kerwin F. Medina
  265.     Limit             (c) J Y Lim
  266.     MAR             (c) Haruhiko Okumura, Richard Schiller
  267.     MDCD             (Public Domain) Mike Davenport
  268.     PAK             (c) NoGate Consulting
  269.     PKZIP, PKSFX,
  270.       PKSFXjr, PKPAK         (c) PKWare Inc
  271.          Power Compressor III   (c) Marco Czudej
  272.     PUT & GET         (c) Microfox Company
  273.     Quantum, PAQ         (c) CinemaTronics
  274.     Quark             (c) Kunz Robert
  275.     RAR             (c) Eugene Roshal
  276.     RKive             (c) Malcolm Taylor
  277.     SAR             (c) Streamline Design
  278.     SH Archive Identier    (c) SH Software, Eero T Heinonen
  279.          SKY                    (c) SkyTech
  280.          RESOF / DESOF          (c) Spectrum Software
  281.     SqWez             (c) JM Software
  282.     SQZ             (c) J I Hammarberg
  283.     The Stirling Compressor(c) Strirling Group
  284.     TAR             (c) Tim V. Shaporev
  285.     UC II             (c) Ad Infinitum Programs
  286.          UFA                    (c) Igor Pavlov
  287.     X1             (c) Stig Valentini
  288.     YAC             (c) Aleksandras Surna
  289.     ZET (R)             (c) Oleg V. Zaimkin
  290.     Zip-Archiv (ZAR)         (c) Torler Peter
  291.     ZOO, ZOO SFX         (c) Rahul Dhesi
  292.          ZPack Lite             (c) SpeedSoft
  293.  
  294. Kiitokset
  295. ---------
  296. Kiitokset tämän version testaajille, Timo Muhoselle ja Jari Arkomalle
  297. ja Heimo Heinoselle, tämän dokumentin englanninkielisen version
  298. oikolukijalle.
  299.  
  300. Myös kiitokset arvokkaasta käyttäjäpalautteesta: George Shadoff (uudet
  301. pakkerit), Raul Gutierrez (hyviä ehdotuksia [mukana jokerimerkkituki]
  302. ja ideoita) ja Al Hall (file_id.diz-ongelman raportointi).
  303.  
  304. Kiitokset myös Archive Comparison Testin tekijälle, Jeff Gilchristille,
  305. sekä WWW- ja FTP-palvelimille, joita käytin ohjelmien hakemiseen.
  306.  
  307. Versiohistoria
  308. --------------
  309. 2.20 (30.04.97)
  310.     - Lisätty seuraavat formaatit: ARJZ, UFA, TSComp, LEO, ZAR,
  311.         SKY, SOF, ZPack Lite, MP3, ZET
  312.          - Lisätty: AIN 2.32 SFX-muoto (edellinen testattu versio 2.20
  313.              ei omannut SFX-ominaisuutta)
  314.          - Korjattu: Rkive-pakettien väärä hälytys
  315.          - Korjattu: nyt tunnistaa vanhempia ARJ SFX-tiedostoja kuin
  316.              v2.20 (testattu 0.20, 1.10, 2.00, 2.10)
  317.          - Korjattu: poistettu file_id.dizin erikoismerkit (aiheutti
  318.              ongelmia TriBBS-systeemeissä)
  319.          - Korjattu: /S (delete largest) -optio ACVT.BTM:ssä
  320.  
  321. 2.10 (10.02.97)
  322.     - Lisätty seuraavat formaatit: ACB, RKive, JAR, ESP (+SFX), DPA
  323.     - Parannettu PKZIP-tunnistusta
  324.     - Lisätty lisää virhetarkistuksia (vakaampi)
  325.     - Hieman nopeampi
  326.     - Korjattu: ei tunnistanut isoja DWC-paketteja
  327.     - Korjattu: kaatui pienemmissä ajettavissa (ei SFX) kuin 30 kB
  328.     - Poistettu "uusi" ARJ SFX speksi (turha)
  329.  
  330. 2.00 (05.11.96)
  331.     - Normaalin oletuskäsittelyn (oletus-paluuarvot, 1 parametri)
  332.       ohjelmaa voidaan käyttää nyt kuten TESTFILE:ä tai
  333.       Stacy Smithin ARCIDia: "archid %1 arj zip lha rar .."
  334.     - Lisätty seuraavat formaatit (ja mahd. SFX:t):
  335.         AIN, AMGC, ARX, BSA, ChArc, Codec3, CrossePAC, DWC,
  336.         FOXSQZ, HAP3, Hpack, JRchive, Larc, LHark, Limit, Mar,
  337.         MDCD, Quantum, Quark, SqWez, YAC, X1
  338.     - Kaikki vanhat & uudet formaatit on testattu!
  339.     - Uudelleennumeroidut paluukoodit, normaalit paketit ovat 100
  340.       ja alle
  341.     - File format list 1.50:n mukaan lisätty tuki:
  342.       - Uudemmat ARJ SFX:t
  343.       - Vanhemmat LHA SFX-versiot (<2.13): LHarc 1.xx, LHA 2.10
  344.     - Korjattu tunnistus seuraavien pakettien osalta: LHA, ZOO, GZIP
  345.     - Paranneltu PKSFX-tunnistusta (myös InfoZip)
  346.     - Erottaa LHA- ja LHarc-tiedostot ja SFX:t
  347.     - Erottaa LHarc- ja ARX-tiedostot
  348.     - Erottaa LHA- ja LHark-tiedostot
  349.     - Erottaa myös PKPAK-tiedostot (erikoismetodi)
  350.     - Korjattu ARC/PAK-muodot:
  351.         jotkin PAK-tiedostot tunnistettiin ARC-tiedostoina.
  352.     - Optimoitu vanha osa lähdekoodia
  353.     - Lisätty paluuarvot 249 ja 250
  354.     - Paranneltu apusivu: 2-sarakkeinen lista, jossa selkeät
  355.       otsikot, paussi sekä tarkkailu uudelleenohjauksesta.
  356.       Aikaisemmin 1-sarakkeinen pysähtymätön lista.
  357.     - Näyttää paluuarvot (myös virhekoodien) suluissa.
  358.     - Näyttää viestit "open error", "close error"
  359.  
  360. 1.00 (30.06.96)
  361.     - Ensimmäinen julkinen versio 1.00
  362.     - Lisätty joitakin vanhoja tai harvinaisia muotoja (EI TESTATTU):
  363.       ARC, GZIP, HA, HYP, PAK, SQZ, ZOO
  364.     - Varmennettu LHA-tunnistusta
  365.